home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2004 April / Gamestar_61_2004-04_dvdb.iso / DVDStar / Editace / hltp.exe / {app} / Applications / MilkShape 3D / BWC_Commands.txt < prev    next >
Text File  |  2001-11-20  |  6KB  |  125 lines
  1. .BWC Script Reference Manual
  2. (c) 2001 DragonZap, dragonzap1@aol.com
  3.  
  4. For my MilkShape plug-ins, I've made a script format which is very similar to the
  5. .qc files used for Half-Life, Quake, Quake 2, et al. models. BWC files are used
  6. to generate .CBN files, and if you so choose, you don't even need to make a new
  7. model to use a new .CBN file (for example, if you only wanted to change hair color
  8. or hair length of a creature).
  9.  
  10. .BWC files can also be used to make .HD files, in case you want to change the
  11. skins of the good/evil advisors.
  12.  
  13. BWC Commands:
  14.  
  15. BWCversion <number>
  16.     Determines the version of the plug-in that created the .BWC file.
  17.     This is necessary as the .BWC commands will probably change several times
  18.     before the plug-in is completed.
  19.  
  20. segment <type> <commands>
  21.     Defines a segment. Different segment types have different sets of commands.
  22.     .CBN files use "Creature" segments.
  23.     .HD files use "helpdude" segments.
  24.  
  25. "Creature" segment commands (Used for .CBN files only):
  26. model <name> <filename>
  27.     Sets the filename used for model <name>. <name> can be base, evil, good,
  28.     thin, fat, weak, and strong. <filename> must be the name of an .L3D file
  29.     in the "Data\CreatureMesh" directory, minus the .L3D extension. For
  30.     example, the Ape's base mesh is "c_ape_Boned_Base". Use this command
  31.     to change where Black & White looks for your custom model files so that
  32.     you don't have to overwrite existing .L3D files. As an example, if I
  33.     made, say, a snail creature, I might want to call the base mesh
  34.     "C_DragonZap_snail_base".
  35.  
  36. hairgroup <segment count> <commands>
  37.     Defines a hair group. Hairs in the hair group will be made up of
  38.     <segment count> parts. See below for "hairgroup" block commands.
  39.  
  40. eyes <size> <commands>
  41.     Defines information for creature eyes. There can be only one "eyes"
  42.     block per Creature segment. See below for "eyes" block commands.
  43.  
  44. soundbank <filename>
  45.     Sets the soundbank filename of the creature. Since nobody has a way to
  46.     make custom sounds for creatures yet, there isn't much use for changing
  47.     this yet. (and using it to use a different creature's sounds does not
  48.     seem to work)
  49.  
  50.     <filename> should be the name of the .SAD file as found in the
  51.     "Audio\Creature\SFX" directory, minus the .SAD extension.
  52.  
  53. tattoo <group name> <x> <y> <scale> <rotation> <flipped>
  54.     Sets the positioning of creature tattoos. There can be a maximum of 8
  55.     tattoos.
  56.  
  57.     <group name> should be the name of the triangle group that you used in
  58.     MilkShape. <x> and <y> refer to the pixel position of the center of the
  59.     tattoo on the texture image. <scale> is used to scale those images.
  60.     <rotation> is a number from 0-3 which is the number of times that the
  61.     tattoo image should be rotated 90 degrees clockwise. A value of 2 would
  62.     mean that the tattoo was turned upside-down. If <flipped> is 1, then the
  63.     tattoo will be a mirror image of itself.
  64.  
  65. "hairgroup" block commands:
  66. align <type> <r> <g> <b> <length> <damping> <stiffness> <thickness>
  67.     Sets basic information about creature hair for the current hair group.
  68.     <type> can be base, good, or evil. <r> <g> <b> are numbers from 0-255 and
  69.     are the red, green, and blue values of the hair color. ("0 0 255" would be
  70.     completely blue hair, for example.) <length>, <damping>, <stiffness>, and
  71.     <thickness> all refer to properties of the creature hair. Play around with
  72.     them to get the effects you want.
  73.  
  74. hair <flags> <commands>
  75.     Defines a single hair. The meaning of the flags is not yet known, so
  76.     it should be left alone.
  77.  
  78. "hair" block commands:
  79. intersect <n1> <n2> <n3> <n4> <n5> <n6> <n7> <n8> <n9>
  80.     This command has something to do with the placement of the hair on a
  81.     creature, but it is not yet known what the numbers mean. The numbers
  82.     can, however, be copied from one hair to another to give two hairs the
  83.     same position.
  84.  
  85. sweep <rotx> <roty> <rotz>
  86.     Not sure. May have something to do with how the hair sways.
  87.  
  88. "eyes" block commands:
  89. eye <n1> <n2> <n3> <n4> <n5> <n6> <n7> <n8> <n9> <n10>
  90.     Has something to do with the placement of eyes on a creature.
  91.     <n2>-<n10> are supposedly the same as the "hair" block's "intersect"
  92.     command's <n1>-<n9>, but I still don't know what they mean. There
  93.     can be up to four "eye" commands, but there seem to be two for
  94.     each eye. (That is, normal creatures always come up with four, and
  95.     the Greek [ogre] creature comes up with two.)
  96.  
  97. range <name> <open> <closed> <default>
  98.     Has something to do with how open or closed eyes should be. <name>
  99.     can be "good", "evil", or "base".
  100.  
  101. "helpdude" segment commands (Used for .HD files only):
  102. model <filename>
  103.     Filename of the model used in the .HD file. For now, only models
  104.     that are the original advisor models, (Yogi_Mesh or Demon_Mesh)
  105.     possibly with their skins changed, will work. Models which have
  106.     a different file size will cause Black & White to crash.
  107.  
  108. animations <count>
  109.     The number of animations in the .HD file. Don't change this.
  110.  
  111. flags <flags>
  112.     Possibly a set of flags for the HelpDude, but maybe not. Don't
  113.     change this.
  114.  
  115. name <name>
  116.     A filename for an animation. As of yet, no animations are actually
  117.     extracted or separated, so don't change any of the names.
  118.  
  119. remainder <filename>
  120.     The name of the file containing the rest of the raw data extracted
  121.     from the .HD file. This is why only skin replacement for advisors
  122.     is currently supported -- I don't know what the data means yet,
  123.     but it's necessary to have it.
  124.  
  125. Send questions/comments to dragonzap1@aol.com. English only, please.